/*
 * Fichier: ChapterModel.java
 * Crée le: 08 septembre 2007.
 * Modifié: 26 avril 2012.
 * Auteurs: Sébastien ESTIENNE.
 * SiteWeb: http://www.prog-info.org/
 * 
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */

package javaexos.model;



import java.util.Calendar;
import java.util.List;



/**
 * <p>Interface décrivant un chapitre.</p>
 * @author Sébastien ESTIENNE.
 */
public interface ChapterModel extends Comparable<ChapterModel>
{
   /**
    * <p>Renvoie le numéro du chapitre.</p>
    * @return Retourne le numéro du chapitre.
    */
   public int getNumber();


   /**
    * <p>Renvoie le titre du chapitre.</p>
    * @return Retourne le titre du chapitre.
    */
   public String getTitle();
   
   
   /**
    * <p>Renvoie le nom du chapitre.</p>
    * @return Retourne le nom du chapitre.
    */
   public String getName();


   /**
    * <p>Renvoie la date de création du chapitre.</p>
    * @return Retourne la date de création du chapitre.
    */
   public Calendar getCreation();


   /**
    * <p>Renvoie le nom de l'auteur du chapitre.</p>
    * @return Retourne le nom de l'auteur du chapitre.
    */
   public String getAuthor();


   /**
    * <p>Renvoie true si le chapitre est validé, sinon false.</p>
    * @return Retourne true si le chapitre est validé, sinon false.
    */
   public boolean isValidated();


   /**
    * <p>Renvoie la liste des mots clés du chapitre.</p>
    * @return Retourne la liste des mots clés du chapitre.
    */
   public List<String> getKeyWords();


   /**
    * <p>Renvoie la présentation du chapitre.</p>
    * @return Retourne la présentation du chapitre.
    */
   public String getPresentation();


   /**
    * <p>Renvoie la liste des notions du chapitre.</p>
    * @return Retourne la liste des notions du chapitre.
    */
   public List<String> getNotions();


   /**
    * <p>Renvoie la liste des contributeurs du chapitre.</p>
    * @return Retourne la liste des contributeurs du chapitre.
    */
   public List<String> getContributors();


   /**
    * <p>Renvoie la liste des exercices du chapitre.</p>
    * @return Retourne la liste des exercices du chapitre.
    */
   public List< ? extends ExerciseModel> getExercises();
}
